home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / jprs111.arc / README.JPR < prev    next >
Text File  |  1989-07-09  |  15KB  |  288 lines
  1.        
  2.             ╔══════════════════════════════════════════════════╗
  3.             ║    How to get started with JEPRS version 1.11    ║
  4.             ╚══════════════════════════════════════════════════╝
  5.        
  6.        
  7.        I. What is JEPRS?
  8.        
  9.             JEPRS is a specialized database system used to store,
  10.        retrieve, format, and search for references to the scientific
  11.        literature.  While it was designed by a graduate student in the
  12.        biological sciences, there is no obvious reason JEPRS cannot be
  13.        used by anyone needing easy access to references to any kind of
  14.        books, journals, abstracts, magazines, and other literature.
  15.        
  16.             Note that the files marked below with an asterisk (*) have
  17.        been updated for version 1.11!  Also, please read the information
  18.        at the very end of this file that describes the new features of
  19.        version 1.11; NO CHANGES HAVE BEEN MADE TO THE DOCUMENTATION
  20.        FILES!
  21.        
  22.        
  23.        II.  What's on this disk.
  24.        
  25.             You should find a total of 17 files on this disk.  Below is
  26.        a list of those files and a short description of their use:
  27.        
  28.            *ReadMe.JPR  : The file you are reading now; it contains the
  29.                           most basic information for starting JEPRS.
  30.        
  31.            *JEPRS.Exe   : This is the JEPRS program itself; entering
  32.                           "JEPRS" at the DOS prompt ("C:>") starts the
  33.                           program.  See new features for version 1.11
  34.                           listed at the end of this file.
  35.        
  36.             JPRTutor.JPR: A tutorial text file that you should read
  37.                           before doing any extensive work with JEPRS.
  38.        
  39.             JPRGuide.JPR: The user's guide to JEPRS.  This contains the
  40.                           most extensive information on JEPRS.  It is
  41.                           not meant to be read sequentially; you should
  42.                           refer to it whenever you have specific
  43.                           questions about a specific aspect of the
  44.                           program.
  45.        
  46.            *Help.JPR    : Contains the text for JEPRS's context-
  47.                           sensitive help screens.  If JEPRS can't find
  48.                           this file when it is running, you will not be
  49.                           able to get help by pressing the F1 key.  New:
  50.                           When you press F1 at the Main Menu, the last
  51.                           Help screen is new.  No other Help has changed.
  52.        
  53.             Ref1.JPR    : A sample database file for JEPRS.  It contains
  54.                           the actual text of the database.
  55.        
  56.             Ref1.JPK    : The "key" file that goes along with the
  57.                           Ref1.JPR database file.  YOU CANNOT USE A
  58.                           DATABASE FILE WITHOUT A KEY FILE!
  59.        
  60.             Format.JPR  : A sample format file that contains the
  61.                           formatting instructions, printer control codes
  62.                           (in this case for an IBM Graphics printer and
  63.                           most Epson-compatible printers), and default
  64.                           directory and file name information.
  65.        
  66.             FormStar.JPR: Similar to Format.JPR, except this file has
  67.                           control codes for a Star SG-10 printer.
  68.        
  69.             FormPana.JPR: Similar to Format.JPR, except this file has
  70.                           control codes for a Panasonic KXP-1080i
  71.                           printer.
  72.        
  73.             FormLsr1.JPR: Similar to Format.JPR, except this file has
  74.                           control codes for a Hewlett-Packard LaserJet
  75.                           printer with a 10-point Times Roman regular,
  76.                           bold, and italic font loaded (note that JEPRS
  77.                           doesn't supply you with the actual fonts, but
  78.                           rather it assumes you have them and have
  79.                           already downloaded them to the printer or have
  80.                           them in a cartridge already plugged in).
  81.        
  82.             FormLsr2.JPR: Similar to Format.JPR, except this file has
  83.                           control codes for a Hewlett-Packard LaserJet
  84.                           printer using the condensed (16.5 characters
  85.                           per inch) font.
  86.        
  87.             FormLsr3.JPR: Similar to Format.JPR, except this file has
  88.                           control codes for a Hewlett-Packard LaserJet
  89.                           printer using the standard 10 characters per
  90.                           inch Courier font.
  91.        
  92.            *Text.JPR    : Sample text file.  Since you cannot directly
  93.                           access the database using the DOS Type
  94.                           command, JEPRS allows you to enter selected
  95.                           references into an ASCII/DOS text file.  You
  96.                           can use DOS's Type and Print commands on these
  97.                           text files.
  98.        
  99.             Number.JPR  : This is a sample "number" file.  It is really
  100.                           a normal ASCII/DOS text file, but consists of
  101.                           nothing but numbers of references.  JEPRS can
  102.                           create this file (for example, in a >Search)
  103.                           and then use its contents during formatting
  104.                           (on the >Format screen).
  105.        
  106.             Procomm.Log : A sample MEDLINE-formatted file.  This can be
  107.                           used in the >Options>MedLine command to add a
  108.                           MEDLINE-formatted file to the database.  (This
  109.                           is probably only of interest to biological/-
  110.                           medical researchers who use MedLine-formatted
  111.                           files.)
  112.        
  113.            *Order.JPR   : This is an order form for registering your use
  114.                           of JEPRS.  You should print this file on your
  115.                           printer and then fill out the information
  116.                           requested.  New:  clarification of free update
  117.                           offer.
  118.        
  119.        *--updated file for version 1.11!
  120.        
  121.        III.  Starting JEPRS.
  122.        
  123.             Before starting JEPRS for the first time, MAKE A COPY OF THE
  124.        FILES ON THIS DISK!  NEVER use your original disk to run the
  125.        program.  This is especially true with a Shareware program like
  126.        JEPRS, since in order for the documentation to be correct (and
  127.        prevent major hassles for other users) you must distribute the
  128.        software EXACTLY as you received it.
  129.        
  130.             Once you make a copy of this disk, insert the copied disk
  131.        into one of your floppy drives.  Then MAKE SURE that that drive
  132.        is the default drive (i.e., if you placed the JEPRS disk in drive
  133.        A:, make sure you enter "A: <return>" at the DOS prompt).
  134.        
  135.             In order to get the most out of your initial try-out of
  136.        JEPRS (and to avoid getting any error messages), make sure the
  137.        following files are on the disk in the default drive:
  138.                             JEPRS.Exe
  139.                             Ref1.JPR
  140.                             Ref1.JPK
  141.                             Format.JPR
  142.                             Help.JPR
  143.             Then enter "JEPRS" at the DOS prompt and follow the
  144.        instructions on the screen.  Note that you can press the <F1>
  145.        function key to get help whenever you see "<F1>=Help" on the
  146.        bottom of the screen (almost all the time).
  147.        
  148.        IV.  What do I do Next?
  149.        
  150.             After you get over your initial excitement over the
  151.        wonderful features of JEPRS, you should go through the tutorial
  152.        provided.  This is a file called JPRTutor.JPR.  Print it out on
  153.        your printer by either of two methods:
  154.        
  155.                  1.  Enter "Copy JPRTutor.JPR Lpt1:" at the DOS prompt
  156.        
  157.                  ...or...
  158.        
  159.                  2.  Enter "Print JPRTutor.JPR" at the DOS prompt
  160.                      and then press <enter> when asked "Name of print
  161.                      device?".
  162.        
  163.             After printing out and going through the tutorial, you may
  164.        have more advanced questions.  In that case print out the
  165.        extensive documentation file called JPRGuide.JPR by either of the
  166.        two methods described for the JPRTutor.JPR file (but of course
  167.        replacing the JPRTutor.JPR filename with JPRGuide.JPR).
  168.        
  169.        V.  New for version 1.11 of JEPRS.
  170.        
  171.             Two things have happened with the change from version 1.10
  172.        to version 1.11:  a small bug has been fixed, and several
  173.        command-line options have been added.  Also, pricing and update
  174.        information has been clarified in the order form.
  175.        
  176.             Bug.  While at the List Screen in version 1.10, if you
  177.        entered any function key other than the ones listed on the
  178.        screen, you got stuck and were unable to display other
  179.        references.  Let's say you entered "45" to look at reference #45:
  180.        it would be displayed correctly.  If you then pressed <F3> for
  181.        example, you would no longer be able to continue to display other
  182.        references.  Of course <F3> is not a valid key at the List
  183.        Screen, but it shouldn't have caused any problems.  There were 2
  184.        ways to clear the error in version 1.10: either return to the
  185.        Main Menu and then come back to the List Screen, or press <PgUp>
  186.        or <PgDn>.  This bug has been zapped in version 1.11!
  187.        
  188.             Command-Line Options.  In version 1.10, there was only one
  189.        command-line option:  the format file name.  (For example, if you
  190.        had a format file called "MyFormat.JPR", you could specify it on
  191.        the command line by entering "JEPRS MyFormat.JPR".)  Version 1.11
  192.        has added four flags to that:
  193.        
  194.             /A    :  Amber monitor with color graphics video card
  195.             /G    :  Green monitor with color graphics video card
  196.             /B    :  turn Blinking OFF for search & formatted output
  197.                      sent to the screen
  198.             /C    :  turn Colors OFF for search & formatted output sent
  199.                      to the screen
  200.        
  201.             "/A" and "/G" are actually the same command but were
  202.        implemented for mnemonics.  These are for people that have a CGA,
  203.        EGA, or VGA video board but who are using a black and white
  204.        (green or amber) monitor.  Since JEPRS normally uses both amber
  205.        (yellow) and green text, these would otherwise not appear on
  206.        these monitors.  What this command does is simply make all text
  207.        either black, gray, or white.  (Note:  if you are using a
  208.        monochrome "MDA" or Hercules compatible video card with a green
  209.        or amber monitor, you do NOT need to enter this command!)
  210.        
  211.             "/B" and "/C" are for those people who are driven nuts by
  212.        the large number of colors and blinking text on the search and
  213.        format displays.  My original intent was not to annoy people (!)
  214.        but simply try to provide a WYSIWYG ("What-You-See-Is-What-You-
  215.        Get") display:  on color monitors, normal text was black on cyan,
  216.        underline was blue on black, bold was white on black, bold +
  217.        underline was bright blue on black, and italics was blinking;  on
  218.        monochrome monitors, normal text was black on gray, underlining
  219.        was underlined, bold was white on black, bold + underline was
  220.        white and underlined on black, and italic was blinking.  I
  221.        thought it was a great idea, but it apparently annoyed a lot of
  222.        people!  So "/B" will turn off blinking only, and "/C" will turn
  223.        off BOTH blinking AND the variety of colors (everything will
  224.        appear as black on cyan [color monitor] or black on gray
  225.        [monochrome]).
  226.        
  227.             A shortened description has been provided on the Help Screen
  228.        at the Main Menu.  Press <F1> at the Main Menu, and then press
  229.        the space bar twice to get to the third help screen; it contains
  230.        an abbreviated description of what you see here.
  231.        
  232.             Examples.  Let's say you hate blinking characters, and you
  233.        are using an amber monitor with a CGA graphics card.  Start JEPRS
  234.        like this:
  235.                    C:>  JEPRS /B/A
  236.        
  237.             Let's say you're using a color monitor and you're annoyed by
  238.        all the colors in the formatted output on the screen:
  239.                    C:>  JEPRS /C
  240.        
  241.             Let's say you don't like the colors and you use a format
  242.        file called MyFile.JPR:
  243.                    C:>  JEPRS /C MyFile.JPR
  244.                    ...or...
  245.                    C:>  JEPRS MyFile.JPR /C
  246.                    ...or...
  247.                    C:>  JEPRS MyFile.JPR /c
  248.        
  249.             (Note that the order of the options, as well as
  250.        capitalization, make no difference.)
  251.        
  252.             Of course, if you like JEPRS just the way it is, you can
  253.        still start it by just entering "JEPRS" at the DOS prompt.
  254.        
  255.        
  256.        VI.  Version 2.00 ???!!!
  257.        
  258.             My current plans call for version 2.00 to be released in
  259.        October-November 1989.  Registered users of version 1.10 and 1.11
  260.        will automatically receive version 2.00 at no cost (printed
  261.        documentation will be available at an additional charge).
  262.        
  263.             The main changes in version 2.00 will be in ease-of-use.
  264.        All the menus will be like the current Search Menu, where options
  265.        can be set once during execution of the program, and JEPRS will
  266.        remember them until you exit.  Also, Format files will be called
  267.        Config files (for "configuration") and will allow up to 30 format
  268.        definitions (instead of 10) and 5 printer definitions (instead of
  269.        one).  (A FREE conversion program will be sent to REGISTERED USERS
  270.        ONLY, to convert Format files to Config files; the conversion
  271.        program will not be distributed via shareware.)  In addition, you
  272.        will be able to edit the Config File while in JEPRS; you won't
  273.        need an external word processor or editor to edit it.  Many other
  274.        small enhancements will be made, but I'll let you discover them
  275.        yourself when version 2.00 is finally released!
  276.        
  277.        
  278.        VII.  Customer Support.
  279.        
  280.             As before, questions and comments can be sent directly to me
  281.        at the address listed on JEPRS' opening screen.  Also note a new
  282.        addition on that screen:  you can now contact me via CompuServe
  283.        EasyPlex (electronic mail) at #73567,471.  I usually check my
  284.        electronic mail on Fridays and/or Sundays.
  285.        
  286.        Thanks,
  287.        Lou Miranda, author.
  288.